Documentation
Documentation
Copyright © 2014-2017 Juliette Monsel. Version modifiée mise à jour en 2026 par Brett Cole.
Ce programme est un logiciel libre ; vous pouvez le diffuser et/ou le modifier suivant les termes de la Licence Publique Générale GNU telle que publiée par la Free Software Foundation ; soit la version 3 de cette licence, soit (à votre convenance) une version ultérieure.
Ce programme est diffusé dans l'espoir qu'il sera utile, mais SANS AUCUNE GARANTIE ; sans même une garantie implicite de COMMERCIALISATION ou d'ADÉQUATION À UN USAGE PARTICULIER. Voyez la Licence Publique Générale GNU pour plus de détails.
Vous devriez avoir reçu une copie de la Licence Publique Générale GNU avec ce programme. Sinon, consultez http://www.gnu.org/licenses/.
Vous utilisez Bracelet Designer Pro (2026, Brett Cole), d’après Bracelet Generator de Juliette Monsel. Lancez le programme avec Bracelet Designer Pro.exe (sans fenêtre de terminal supplémentaire).
Allez voir la page du projet Bracelet Générateur sur Sourceforge pour le logiciel d’origine.
Le but de ce logiciel n'est pas de vous apprendre à faire des bracelets brésiliens mais de rendre la création de patrons plus facile. Donc, si vous ne savez pas faire les quatre types de nœuds, reportez vous à un tutoriel sur internet comme friendship-bracelets.net (en anglais), par exemple.
Lancez bracelet-generator-x.y.z.exe et suivez les instructions de l’installateur (il est nécessaire d’avoir les droits d’administrateur pour effectuer l’installation).
Tout d’abord, il faut installer les dépendances manquantes parmi : python3-pil, python3-tk, ghostscript, zenity (optionnel). Pour vérifier si package est installé, vous pouvez utiliser la commande suivante :
$ dpkg-query -W package
Ensuite, pour installer Bracelet Générateur, lancez :
$ sudo dpkg -i bracelet-generator-x.y.z_all.deb
Décompresser l'archive. Placez BraceletGenerator.app dans le dossier /Applications. Pour pouvoir exporter les patrons en .png ou .jpg, il faut installer Ghostscript. Il est possible de le faire avec brew :
$ brew install ghostscript
Sinon, allez voir le site de Ghostscript.Tout d’abord, il faut installer les dépendances manquantes parmi :
Python 3 est certainement déjà installé, mais il faut peut-être installer les autres. Les noms des paquets varient selon les distributions. Voici les noms des paquets pour :
$ pip3 install pillow
Décompressez l’archive et lancez BraceletDesignerPro.py. S’il ne se passe rien, éditez les propriétés du fichier pour le rendre exécutable ou lancez le avec Python : ouvrez un terminal dans le dossier extrait et tapez
$ python3 BraceletDesignerPro.py
Vous pouvez aussi installer Bracelet Générateur (requiert les droits de superutilisateur) avec$ python3 setup.py install
Ensuite le logiciel peut être lancé depuis un terminal avec
$ bracelet-generator
Tkinter sera installé automatiquement avec Python. Mais il faudra installer le module Pillow séparément. Il faudra aussi installer Ghostscript.
Décompressez l'archive et exécutez add_gs_to_path.py pour ajouter l'emplacement de Ghostscript à la variable path du système afin que Bracelet Générateur puisse le trouver. Vous pouvez maintenant lancer BraceletDesignerPro.py.
Je n'ai testé Bracelet Générateur que sous que sous Ubuntu (16.04 LTS), ArchLinux et Windows (7 et 10), donc je ne sais pas quels problèmes vous pourriez rencontrer sous d’autres OS.
$ brew install ghostscript
Tkinter est parfois inclus dans la distribution Python standard ou est disponible sous la forme d'un paquet binaire (pour Linux ou BSD). Si vous utilisez Mac OS X , vous pouvez vous référer à https://www.python.org/download/mac/tcltk.
Décompressez l'archive et lancez bracelet-generator.py.
S'il ne se passe rien, essayez de définir Python comme programme par défaut pour lancer cette application.
Vous pouvez aussi le lancer depuis un terminal en tapant une commande similaire à :
$ python3 BraceletDesignerPro.py
Le logiciel est en Français et en Anglais. J'ai utilisé gettext pour le traduire donc, si vous voulez ajouter ou améliorer une traduction, n'hésitez pas, le fichier BraceletGenerator.pot est disponible dans le dossier po/ du code source.
ou
de la barre du bas (Lignes / Fils).
Vous pouvez aussi saisir le nombre dans les champs à côté.
Lignes et fils changent par deux.
Symétrie verticale du patron (une fois).
Symétrie horizontale du patron (une fois).
H Mirror — Miroir horizontal en direct : éditez la moitié gauche ; la droite suit. Un trait pointillé indique la coupure.
H4 Mirror — Miroir horizontal 4 plis : comme H Mirror (une diagonale devient un V), puis ce V entier est à nouveau miroir en W. Le nombre de fils est forcé à 10, 14, 18, 22, … ; + / − par 4. Exclusif avec H Mirror.
V Mirror — Miroir vertical en direct : éditez la moitié haute ; le bas suit.
Half — Avec V Mirror, ligne où se trouve la coupure verticale (toujours paire).
Repeat render — Répète la bande d’aperçu pour voir le motif en série.
Times (1–20) est le nombre de copies. L’export image, texte et Bracelet Book utilise ce même nombre (nœuds répétés, et repeats dans le HTML).
Rows — Nombre, plus et moins pour les lignes.
Strings — Nombre, plus et moins pour les fils. Un nouveau fil reçoit une couleur absente du patron, très différente du fil voisin.
Randomize colors — Nouvelle palette sur les fils
(arcs-en-ciel, noir/blanc + accent, néons sur fond sombre, duos, etc.).
Avec H Mirror, seule la gauche est tirée au sort, la droite est copiée.
Avec H4 Mirror, seule la moitié gauche intérieure est tirée au sort.
Annuler restaure les couleurs précédentes.
Est. largeur × longueur — Affiché en permanence. Fil à broder 6 brins :
environ 1 mm de large par fil (18 fils ≈ 1,8 cm), et environ 10 rangs par cm de long.
La longueur utilise le nombre de rangs × Repeat render. La tension change la taille réelle.
Show ouvre une vue de dessus d’une main féminine adulte typique,
bracelet posé à plat sur le poignet (non enroulé), à la taille estimée.
Nouveau, Ouvrir, Fichiers récents, Enregistrer, Enregistrer sous, Quitter, plus :
Export as picture — PNG, JPEG ou PostScript (Ghostscript pour PNG/JPEG). Ctrl+E.
Export as text — Codes de nœuds : 0 = avant, 1 = arrière, 2 = bf, 3 = fb. Maj+Ctrl+E.
Export to Bracelet Book — Page HTML : image, pastilles (clic pour copier le hex), ordre des couleurs, nœuds f / b / bf / fb.
Import from Bracelet Book — Coller Colors used, Colors order et Knots. Les miroirs en direct sont désactivés. Les nœuds vides Bracelet Book (0) ne sont pas pris en charge.
H Mirror, H4 Mirror et V Mirror restent actifs pendant le travail, contrairement aux boutons de symétrie ponctuelle.
Les couleurs des fils viennent d’une palette moyenne. Cliquez un carré pour le sélecteur circulaire. Glissez un carré sur un autre pour copier sa couleur. Utilisez Randomize colors pour un schéma complet.
Le menu Templates (à côté de Fichier) liste chaque fichier .bracelet du dossier templates/. La liste est reconstruite à chaque ouverture du menu : un fichier ajouté dans ce dossier apparaît tout de suite (extension .bracelet). Ouvrir un modèle ne définit pas le chemin d’enregistrement : Enregistrer n’écrasera pas le modèle.
Save as template (menu Fichier, ou première ligne de Templates) enregistre une copie dans templates/, sans changer le fichier en cours.
Settings → Preferences ouvre les options de démarrage :
Une seule de ces options est active.
Save as template (menu Fichier, ou le premier item sous Templates) enregistre une copie dans templates/. Cela ne change pas le chemin d’enregistrement courant.
BraceletBook utilise les nœuds f, b, bf, fb, des hex « colors used » (lettres a, b, c…) et un « colors order » du type abbaabba.
L'éditeur de motifs bicolores vous permet de créer librement un motif bicolore, et ensuite, le patron correspondant
sera automatiquement généré.
/ 
.
ou
. Vous pouvez également in-
diquer directement le nombre de lignes / fils à côté
des boutons .
Ouvrir un fichier .bicolor (efface le motif en cours).
Enregistrer le motif.
Générer le patron correspondant au motif qui sera alors détruit.
Enregistrez le pour pouvoir le modifier plus tard.
Effacer le motif. Attention, vous ne pourrez pas revenir en arrière.
Ouvrir l’outil de translation.
Rotation du motif dans le sens anti-horaire.
Rotation du motif dans le sens horaire.
Symétrie verticale du motif.
Symétrie horizontale du motif.
Quitter l'éditeur.
Cet outil permet de translater le motif de manière périodique dans les directions données par les flèches.
Les patrons fournis sont dans le dossier templates/ à côté du programme (chevrons, diamant, et tout fichier .bracelet que vous y ajoutez). Ouvrez-les depuis le menu Templates.
Bonne utilisation !
Si vous rencontrez des erreurs lors de lors de l'export des patrons en .png ou .jpg, ou si aucune image n'est créée, vérifiez que Ghostscript est bien installé sur votre ordinateur. Si ce n'est pas le cas, installez le, l'export devrait alors fonctionner. Sous Windows, lancez add_gs_to_path.py dans le dossier du programme pour ajouter Ghostscript à la variable path du système.
Une fenêtre de console py.exe signifie que l’application a été lancée avec le lanceur Python en mode console. Utilisez Bracelet Designer Pro.exe.
Pour cette version modifiée, contactez Brett Cole. Pour le projet d’origine, créez un ticket sur la page Sourceforge ou envoyez un email à j_4321@protonmail.com.